home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / MPI_Bsend.z / MPI_Bsend
Encoding:
Text File  |  2002-10-03  |  4.5 KB  |  133 lines
  1.  
  2.  
  3.  
  4. MMMMPPPPIIII____BBBBSSSSEEEENNNNDDDD((((3333))))                                                      MMMMPPPPIIII____BBBBSSSSEEEENNNNDDDD((((3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      MMMMPPPPIIII____BBBBsssseeeennnndddd - Performs a basic send with user-specified buffering
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      C:
  13.  
  14.           #include <mpi.h>
  15.  
  16.           int MPI_Bsend( _b_u_f, _c_o_u_n_t, _d_a_t_a_t_y_p_e, _d_e_s_t, _t_a_g, _c_o_m_m )
  17.           void             *_b_u_f;
  18.           int              _c_o_u_n_t, _d_e_s_t, _t_a_g;
  19.           MPI_Datatype     _d_a_t_a_t_y_p_e;
  20.           MPI_Comm         _c_o_m_m;
  21.  
  22.  
  23.      C++:
  24.  
  25.           #include <mpi.h>
  26.  
  27.           void Comm::Bsend(
  28.           const void*       _b_u_f,
  29.           int               _c_o_u_n_t,
  30.           const Datatype&   _d_a_t_a_t_y_p_e,
  31.           int               _d_e_s_t,
  32.           int               _t_a_g) const
  33.  
  34.  
  35.      Fortran:
  36.  
  37.           INCLUDE "mpif.h" (or USE MPI)
  38.  
  39.           <type> BUF(*)
  40.           INTEGER _c_o_u_n_t, _d_a_t_a_t_y_p_e, _d_e_s_t, _t_a_g, _c_o_m_m,
  41.           _i_e_r_r_o_r
  42.  
  43.           CALL MPI_BSEND(_b_u_f, _c_o_u_n_t, _d_a_t_a_t_y_p_e, _d_e_s_t,
  44.           _t_a_g, _c_o_m_m, _i_e_r_r_o_r)
  45.  
  46.  
  47. SSSSTTTTAAAANNNNDDDDAAAARRRRDDDDSSSS
  48.      This release implements the MPI 1.2 standard, as documented by the MPI
  49.      Forum in the spring 1997 release of _M_P_I:  _A _M_e_s_s_a_g_e _P_a_s_s_i_n_g _I_n_t_e_r_f_a_c_e
  50.      _S_t_a_n_d_a_r_d.
  51.  
  52. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  53.      The MMMMPPPPIIII____BBBBsssseeeennnndddd routine performs a basic send operation with user-specified
  54.      buffering.  This routine accepts the following parameters:
  55.  
  56.      _b_u_f         Specifies the initial address of the send buffer (choice)
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. MMMMPPPPIIII____BBBBSSSSEEEENNNNDDDD((((3333))))                                                      MMMMPPPPIIII____BBBBSSSSEEEENNNNDDDD((((3333))))
  71.  
  72.  
  73.  
  74.      _c_o_u_n_t       Specifies the number of elements in the send buffer
  75.                  (nonnegative integer)
  76.  
  77.      _d_a_t_a_t_y_p_e    Specifies the data type of each send buffer element (handle)
  78.  
  79.      _d_e_s_t        Specifies the rank of the destination (integer)
  80.  
  81.      _t_a_g         Specifies the message tag (integer)
  82.  
  83.      _c_o_m_m        Specifies the communicator (handle)
  84.  
  85.      _i_e_r_r_o_r      Specifies the return code value for successful completion,
  86.                  which is in MPI_SUCCESS.  MPI_SUCCESS is defined in the
  87.                  mmmmppppiiiiffff....hhhh file.
  88.  
  89. NNNNOOOOTTTTEEEESSSS
  90.      This send operation is provided as a convenience function; it allows the
  91.      user to send messages without worrying about where the messages are
  92.      buffered (of course, the user must have provided buffer space by using
  93.      the MMMMPPPPIIII____BBBBuuuuffffffffeeeerrrr____aaaattttttttaaaacccchhhh(3) routine).
  94.  
  95.      The buffer space cannot be reused unless you are certain that the message
  96.      has been received (not just that it should have been received).  In C,
  97.      you can force the messages to be deliverd by using the following
  98.      routines:
  99.  
  100.           MPI_Buffer_detach( &b, &n );
  101.           MPI_Buffer_attach( b, n );
  102.  
  103.  
  104.      (The MMMMPPPPIIII____BBBBuuuuffffffffeeeerrrr____ddddeeeettttaaaacccchhhh(3) routine will not complete until all buffered
  105.      messages are delivered.)
  106.  
  107. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  108.      MMMMPPPPIIII____BBBBsssseeeennnndddd____iiiinnnniiiitttt(3),MMMMPPPPIIII____BBBBuuuuffffffffeeeerrrr____aaaattttttttaaaacccchhhh(3), MMMMPPPPIIII____BBBBuuuuffffffffeeeerrrr____ddddeeeettttaaaacccchhhh(3),
  109.      MMMMPPPPIIII____IIIIbbbbsssseeeennnndddd(3)
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.